COMMAND SUBSTITUTION SYSTEM 


(CSS) 


COMMANDS 


COMMAND SUBSTITUTION SYSTEM 
(CSS) 


CSS IS AN EXTENSION TO THE OS/32 COMMAND LANGUAGE . 


CSS ENABLES THE USER TO ESTABLISH FILES. OF DYNAMICALLY 
MODIFIABLE COMMANDS, 


A CSS CAN BE CALLED FROM THE TERMINAL OR FROM OTHER 
CSS FILES. 


CSS"s ARE EXECUTED IN A PREDEFINED WAY. 


CSS PROVIDES: 


© THE ABILITY TO SWITCH THE COMMAND INPUT STREAM TO 
A FILE OR DEVICE 


@ A SET OF LOGICAL OPERATORS TO CONTROL THE PRECISE 
SEQUENCE OF COMMANDS 


@ PARAMETERS THAT CAN BE PASSED TO A CSS FILE SO THAT 
GENERAL SEQUENCES CAN BE WRITTEN TO TAKE ON SPECIFIC 
MEANING WHEN THE PARAMETERS ARE SUBSTITUTED 


@ JHE ABILITY FOR ONE CSS FILE TO CALL ANOTHER SO 
COMPLEX COMMAND SEQUENCES CAN BE DEVELOPED. 


CSS COMMANDS : 
® ALL CSS COMMANDS START WITH THE $ CHARACTER 


@ ALL MIM SUPPORTED COMMANDS CAN BE USED IN A CSS FILE, 


A CSS FILE IS SIMPLY A SEQUENTIAL TEXT FILE. IT CAN BE A DECK OF 
CARDS, A MAGNETIC TAPE, OR A DISK FILE. 


AN EXAMPLE OF A SIMPLE CSS FILE IS: 
" THIS IS A EXAMPLE OF A CSS FILE 
LOAD EMPRG/G, 548 “#7°“7 
ALLOCATE ABCEMP.DAT,CO, 40 
ASSIGN 1, INPUT.DAT 
ASSIGN 2,ABCEMP. DAT 
ASSIGN 5, CON: 
ASSIGN 3,PR: 
START 
$EXIT 


THIS CSS LOADS THE PROGRAM EMPRG.TSK FROM THE GROUP ACCOUNT INTO MEMORY, 
ALLOCATES ALL THE FILES AND DEVICES NECESSARY, AND STARTS EXECUTION OF 
THE PROGRAM, 


NAMING CONVENTIONS 


THE FILE DESCRIPTOR FOR A CSS IS LIKE THOSE OF OTHER FILES, EXCEPT 
THAT TT MUST HAVE AN EXTENTION OF CSS, 


EXAMPLE : 


EOM.CSS 
UPDATE.CSS 
MT62:TERIL.CSS 
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put 
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CALLING A CSS FILE: 


A CSS FILE IS CALLED AND EXECUTED FROM THE TERMINAL BY SPECIFYING 
THE FILE DESCRIPTOR. IF THE LEADING CHARACTERS OF A CSS FILE 
DESCRIPTOR ARE THE SAME AS A COMMAND, MIM ASSUMES THE COMMAND. 


EXAMPLE : 


CLO.CSS - ASSUMES THE CLOSE COMMAND 
AS3,CSS - ASSUMES THE ASSIGN COMMAND, 


BY SPECIFYING A VOLUME NAME AND/OR EXTENSION, A CSS FILE THAT 
OTHERWISE WOULD CONFLICT WITH A MIM COMMAND CAN BE CALLED. 


EXAMPLE : 


MIl61:CLOSE 
MTl61:CLOSE,CSS 
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CSS FILENAMES CAN HAVE PARAMETERS 


THE PARAMETERS CAN BE ENTERED AFTER THE CSS FILE DESCRIPTOR AND ARE 
SEPARATED FROM IT BY ONE CHARACTER SPACE, 


EXAMPLE: 
EOM JANUARY 
RUNJOB PR: 


IF THERE IS MORE THAN ONE PARAMETER SEPARATE EACH WITH A COMMA, 


EXAMPLE : 
RUNPROJ MI61:,MT62:,RPR: 
EOD MONDAY, MI62:OUTPUT.DAT 


IF A PARAMETER MUST PASS A COMMA PLACE A DOUBLE QUOTE “ AROUND 
THE PARAMETER. 


IN OTHER WORDS - - - - 


IF A PARAMETER CONTAINS THE DOUBLE QUOTE CHARACTER ALL PARAMETERS UP 
TO THE NEXT DOUBLE QUOTE CHARACTER ARE PASSED AS ONE PARAMETER. 


EXAMPLE : 
RUNACCT "ACCOUNTING REPORT, APRIL” 
PRIRPT “THIS REPORT IS FOR: MON, TUE AND WED” 
ABC P1,"P2A,P2B" 
@ |=?! 
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NULL PARAMETERS ARE PERMITTED. 


EXAMPLE : 


JUMP 4.C 
CALLS CSS FILE JUMP.CSS ON THE DEFAULT VOLUME WITH THE 
THREE PARAMETERS: 


(wv | Z pfuee- 
PARAMETER ONE = NULL @ 2 Syd 
PARAMETER TWO = NULL @3- CO 


PARAMETER THREE = C 
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REFERENCING PARAMETERS 
WITHIN A CSS FILE, A PARAMETER IS REFERENCED BY THE USE OF THE 
SPECIAL SYMBOL: 
‘an 


WHERE n IS A DECIMAL INTEGER NAME INDICATING WHICH PARAMETER IS 
BEING REFERENCED, 


al FIRST PARAMETER 
a5 FIFTH PARAMETER 
a0 HAS SPECIAL MEANING. IT IS USED TO REFERENCE THE 


NAME OF THE CSS FILE IN WHICH IT IS CONTAINED, 
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A STRAIGHT FORWARD TEXT SUBSTITUTION IS EMPLOYED, 


EXAMPLE : 
A CSS FILE RUNPROG CONSISTS OF: 
LOAD al 
ASSIGN 1,a2 
ASSIGN 3,03 
START a5,04 


IT IS CALLED AS: 
ol C or of & 
RUNPROG TEST, CARD: ,MAG1: .UPDATE, 100 


BEFORE THE CSS IS EXECUTED IT IS PREPROCESSED AND ANY REFERENCE TO A 
PARAMETER IS SUBSTITUTED WITH THE CORRESPONDING TEXT, 


THE PREVIOUS EXAMPLE WOULD BE EXECUTED AS: 


LOAD TEST 

ASSIGN 1, CARD: 
ASSIGN 3,MAG1: 
START 100,UPDATE 
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CSS's ALLOW CONCATENATION OF PARAMETERS, 
ALL OF THE FOLLOWING ARE VALID REFERENCES TO PARAMETER 5, 


a5 a SABC a5,EXT 


_1y- 


CONCATENATION REQUIRES CARE WITH NUMBERS, 


12305 REFERENCES PARAMETER 5 
5123 REFERENCES PARAMETER 5123 


A REFERENCE TO A NON-EXISTENT PARAMETER IS NULL. 


-15- 


THE MULTIPLE @ FACILITY ENABLES A CSS FILE TO ACCESS PARAMETERS 
OF HIGHER LEVEL FILES. 


THE MAXIMUM DEPTH IS SPECIFIED AT SYSTEM GENERATION TIME. 
ada2 IN A CSS FILE REFERS TO THE SECOND PARAMETER OF THE CALLING 
Pics 


WHAT DOES a5 REFERENCE? 


WHAT DOES aa@al1 REFERENCE? 


1G 


GIVEN A CSS CALL: 
YEAR ABC, XYZ, PDQ 


WHAT IS a1? f*° 

WHAT IS a2? *7* 
9 

WHAT IS 932 ?' 


WITHIN YEAR,.CSS THERE IS A REFERENCE TO DAY 
DAY MON, TUE,WED, THUR 


WITHIN DAY.CSS WHAT IS 
al? mon 
a? 

a 

gal? 

a2? “1% 
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GIVEN THE CSS CALL: 
YEAR ABC, XYZ, PDQ 


CALLING: 
DAY MON, TUE, WED, THUR 


AND WITHIN DAY.CSS THERE IS A REFERENCE TO MONTH: 
MONTH DSC1:,PR: 


WITHIN MONTH.CSS WHAT IS: 
al? Poel 
“agus THAR 


1S agrme 
aan? x¥* 


YEAR.CSS YEAR. CSS 


? 


al = ABC ; 
92 = XYZ DAY NON, TUE,WED, THUR 
a3 = PDQ | 
sEXIT 
DAY. CSS 
al = MON 
92 = TUE 
93 = WED 
a4 = THUR SEXIT 
MONTH. CSS MONTH.CSS 
al = DSCL: : 
a2 = PR: $EXIT 


ee 


§.5.5 SEXIT Command 
The SEXIT command terminates a CSS. procedure. Control is 
returned to the calling CSS procedure or .tthe terminal if the CSS 


procedure was called from the terminal. All commands on the 
lines after the SEXIT command are ignored. 


Format: 


SEXI? pt BAIT 
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5.5.2 SCLEAR Command 
The SCLEAR command terminates a CSS stream, closes all CSS files, 
and deactivates CSS. 
Format: 
SCLEAR 


Functional Details: 


The SCLEAR command can be entered in command mode, task loaded 
mode, and task executing mode. 
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5.5.4 SCOPY and SNOCOPY Commands 


The SCOPY and SNOCOPY commands control the Ilisting of CSS 
commands on the terminal or log device (if from batch). SCOPY 
initiates the listing and all subsequent commands are copied to 
the terminal before being executed. The SNOCOPY command 
deactivates the listing, but is itself listed. The SCOPY command 
is an aid in debugging CSS job streams. 


Format: “ 
scopy 
SNOCOPY es aid 
Rae 
K eory iy 4 
aLAa Trane 
DAT 
Brae ava 
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5.5.15 SWRITE Command 
The SWRITE command writes a message to the terminal or log device 
for both interactive and batch jobs.. 
Formats: | 
SWRITE text [3] 


Functional Details: 


The message is output to the terminal or log device. It begins 
with the first nonblank character after SWRITE and ends with a 
semicolon or carriage return. The semicolon is not printed. 


qn 


a a 


ea 


5.5.14 SWAIT Command 
The SWAIT command suspends execution of a CSS _ for 


period of time. 


Fornat: 


Functional Details: 


a specified 


The SWAIT command will only function from a CSS routines. 


When the SWAIT command is entered and the user does not want to 
wait the specified time, a SCONTINUE command can be entered. 


I y- 


525-10 SPAUSE Command 


The SPAUSE command suspends execution of a CSS procedure. 


Format: 


SPAUSE 


Functional Details: 


When SPAUSE is entered, the CSS procedure remains suspended until 
the SCONTINUE command is entered or the SCLEAR command is entered 
to terminate a procedure suspended by a SPAUSE. 


5.5.3 SCONTINUE Command 


The SCONTINUE command resumes’ execution 
suspended by a SPAUSE or SWAIT command. 


Formats: 


of 


a 


CSS 


procedure 


> ab ee ee oO CO oO 4 OP OE OD OF aD 


| S$JOB and | 
{ STERMJOB | 
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5.5.8 S$JOB and STERMJOB Conmands 


The SJCB and STERMJOB commands set the boundaries of a 


CSS job. 


The SJOB command indicates the start, and the STERMJOB command 


indicates the end of a CSS job that contains all the user CSS 
commands and tasks. 
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Format: is gov 
qf ok CO" GPRM CBE. 
we , 2B 
SJOE unt ene a 
as L# nerd 
[CPUTIME=maxtine] KR HoK 
g = eee = oT 
(,classid iocounty][, eclassid focount 32] peer 
; J ahrs as 
, Tha PPE 
STERMJOB ee 
BELT 
5-14 


a De 


Functional Details: 


The SJOB and STERMJOB commands are not necessary in a CSS 
procedure. However, they help prevent errors in one CSS job fron 
affecting other CSS jobs. If a CSS job contains an error, the 
Statements remaining in that job are skipped until a STERMJOB 
command is found. The next command executed is the first command 
found after a STERMJOB command. If the next command is a SJOB 
command signifying the start of a new CSS job, it could be 
skipped because the system is looking for a STERMJOS that 
signifies the end of the CSS job containing the error. 


The CSS job containing an error is aborted, and the end of task 
code is 255. The SJOB command resets the end of task code to 0 
for the next CSS job. 


Interactive jobs have no default limits established at sysgen 
time. However, the user can specify CPU time and I/90 transfer 
limits for a particular job through the $JOB command. 


Any limits in the SJOB command found in a batch stream are 
ignored if limits were already specified in the SIGNON command. 
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5.5213 SSKIP Command 


The SSKIP command is used between the SJOB and STERMJOB commands. 
The SSKIP command indicates that subsequent commands are to be 


skipped until a STERMJOB command is found. The end of task code 
is set to 255. 


Format: 
# po 
SSKIP Loh pRvE 
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5.5.1 SBUILD and SENDB Commands 


The SBUILD command causes succeeding lines to be copied to a 
specified file up to, put excluding, the corresponding SEN DB 
command. Before each line is copied, parameter substitution is 
performed. 


Formats 
fd 
SBUILD [-APPEND] 
lu 
SENDB 


Functional Details: 


The SBUILD command must be the last command on its input line. 
Any further information on the line is treated as a comment and 


is not copied to the file, 


The SENDB command must be the first command in the command line, 
but it need not start in column 1. Other commands can follow 
SENGB on the command line, but nesting of SBUILD and SENDB is not 


permitted. 
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5.5.12 SET CODE Command (9 


The SET CODE command modifies the end of task code 
currently selected CSS task. 
Format: 
SET CODE n 
Parameter: 
n is a decimal number from 1 through 254, 


of 


the 
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VARTABLES 
THERE ARE TWO TYPES OF PSEUDO DEVICE VARIABLES: 


@ GLOBAL 
@ LOCAL 


THE MAXIMUM NUMBER OF VARIABLES THAT CAN BE DEFINED IS ESTABLISHED 
AT SYSTEM GENERATION TIME. 


25) 


as 
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pple 
NAMING VARTABLES 
A VARTABLE NAME CAN CONSIST OF: 


® ONE THROUGH EIGHT CHARACTERS: THE FIRST MUST BE ALPHABETIC 
AND ALL OTHERS ALPHANUMERIC, 


@ AN @ SIGN WHICH MUST PRECEDE THE VARTABLE NAME. 
EXAMPLE : 


aCNT 
a1DX10 
a J 


ee, 


GLOBAL VARIABLES 


@ EXIST FROM SIGNON JO SIGNOFF. 


e MAY BE FREED USING THE $FREE COMMAND. 


ah lbs. 


LOCAL VARIABLES 


CAN BE USED ONLY WITHIN THE CSS LEVELS IN WHICH THEY ARE 
DEFINED, 


WHEN A PARTICULAR CSS LEVEL IS EXITED, ALL LOCAL VARIABLES 
DEFINED WITHIN IT ARE FREED, 


DEFINING VARIABLES 


e ALL VARIABLES MUST BE DEFINED BY NAME USING THE $GLOBAL AND 
$LOCAL COMMANDS. 


@ 10 SET A VARTABLE 10 A SPECIFIC VALUE, USE THE $SET COMMAND. 


aoe 
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5.5.7 SGLOBAL Command 
The SGLOBAL command names a global variable and specifies’ the 


maximum length of the variable to which it can be set by the SSET 
command. 


Format: 


. length length 
SGLOBAL varname geoerVarname 
8 8 


Parameters: 


varcname is a 1- to §8-character name (the first 
character is alpabetic) preceded by the a 
sign, identifying a global variable. 


length is a decimal number from 4 through 32 
specifying the length of the variable defined 
by the SSET command. If this parameter is 
omitted, the default is 8. 


Example: 


SGLOBAL @A(6) 


2A = 


-13 
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§.5.9 SLOCAL Command 


The SLOCAL command names a local variable and specifies the 


maximum length 
command. 


variable to which it can be set by tha SSET 


Format: 
length Length 
SLOCAL varname ypeees,ValLname 
8 8 
Parameters; 
varname is a  1- to 8-character name (the first 
character is alphabetic) preceded by the a 
sign, identifying a local variable. 
length is a decimal number from 4 through 32 
specifying the length of the variable defined 
by the SSET command. If this parameter is 
omitted, the default is 8. 
Example: 


SLOCAL @AC4) 


5.5.11 SSET Command 


The SSET command establishes the value of a named 
Variable, 


Pseudo device 


Format: 


SSET varname=e 


Functional Details: 


Expressions for this command are concatenations of variables, 
parameters, and character strings. No operators are allowed in 


an expression. If a character string is includad in an 
expression, it must be enclosed between apostrophes (°). If an 
apostrophe is part of the character string, it must be 


represented as two apostrophes (‘'). 


The initial value of the variable is blanks. This allows the 
STFNULL and SIFNNULL ccommands to test for a null or not null 
value. 


Examples: 


SSET dA = @AAIAA2 
SSET dA = @A1*. MACS 
SSET @A = at 


SSET 9A = *AS*B® 
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5.5.6 SFREE Command 


The SFREE command frees one or more pseudo variables. 
Format: 

SFREE varname, [,...,varnameg] 
Parameters? 


varnane is a 1- to 8-character name specifying the 
variable whose name and value are to be freed. 


Examples: 


SFREE aA 
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RESERVED VARTABLES 


VARTABLE NAMES STARTING WITH THE CHARACTER STRING @SYS ARE RESERVED 
FOR SYSTEM USE. 3664 

“ 

A USER HAS READ AND WRITE ACCESS TO @SYS VARIABLES. 
A USER CANNOT DEFINE VARIABLES STARTING WITH @SYS, 


aSYSCODE = CONTAINS THE VALUE OF THE LAST END OF TASK CODE FOR 
A PARTICULAR SESSION, 


ale 


CSS ALLOWS LOGICAL IF COMMANDS, 
@ END OF TASK CODE TESTING 
@ FILE EXISTENCE TESTING 
@ VOLUME EXISTENCE TESTING 
e FILE EXTENSION EXISTENCE TESTING 
@ PARAMETER EXISTENCE TESTING 


® COMPARING TWO ARGUMENT TESTING 
} 


cent 
He. ak’ 


hs 


EACH LOGICAL IF COMMAND ESTABLISHES A CONDITION THAT IS TESTED BY THE 
CSS PROCESSOR, IF THE RESULT OF THIS TEST IS TRUE, COMMANDS UP TO A 
CORRESPONDING $ELSE OR $ENDC COMMAND ARE EXECUTED. IF THE RESULT OF 
THIS TEST ITS FALSE THE COMMANDS AFTER THE $ELSE ARE EXECUTED UP TO THE 
CORRESPONDING $ENDC, OR THE CORRESPONDING $ENDC IS EXECUTED. 
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SIF 


< STMT, > 
1 THESE STATEMENTS ARE EXECUTED 
< SIMs > ONLY IF THE CONDITION IS TRUE, 
< SIMI, > 
$ELSE 
< STMT, > 
: THESE STATEMENTS ARE EXECUTED 
© SIlp: > ONLY IS THE CONDITION IS FALSE. 
& : 
< STMT, 5 


SENDC 


@ THE $ENDC COMMAND DELIMITS THE RANGE OF A LOGICAL IF, 


@ NESTING ITS PERMITTED. 


RULE: IF YOU HAVE AN $IF STATEMENT YOU MUST ALWAYS HAVE AN $ENDC 
STATEMENT. THE TOTAL NUMBER OF $IF STATEMENTS IN A CSS 
MUST EQUAL THE TOTAL NUMBER OF -$ENDC STATEMENTS, 


VALID EXAMPLES OF LOGICAL IF COMMANDS: 


SIF $F SIF - $1F 
me $ELSE i $ELSE 
$ENDC - $ENDC iM 
SIF $ENDC 
som __ $ENDC 
| $ENDC 
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SIF 
SIF 
$ELSE 
—$ENDC 
SELSE 


___ $ENDC 


INVALID EXAMPLES OF LOGICAL IF COMMANDS: 


SIF SIF 
sir sELSE 

Lo se npc $1 F 
stnoc 


$ELSE 


¢ 
L— $ENDC 
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END OF TASK CODE TESTING 


THE END OF TASK CODE IS A HALFWORD QUANTITY MAINTAINED FOR EACH USER 
BY THE SYSTEM, 


IT IS SET OR RESET IN ANY OF THE FOLLOWING WAYS: 


SET CODE n 


SJOB 


Command errocr 


SSKIP 


CANCEL 


This command, which can be included in a cSS 
file or entered at the terminal, sets the end 
of task code to Nn. 


As part of its start job function, this 
command resets” the end of task code for the 
current CSS task to QO. 


A command error causes the CSS mechanism to 
skip to STERMJOB assuming that a $JOB was 


executed. (If no SJOB was executed, CSS- 


terminates.) To indicate that the skip took 
place, the end of task code is set to 255. 


This command has the same effect as a command 
eLCLocr. 


When any task terminates by executing the end 
of task program command (SVC 3,n), the end of 
task cede for that task is set to n. 


When a task is cancelled, the end of task code 
is set ta 255. 


i ( Ou 


The six commands available for testing the end of 


task code of 


the currently selected CSS task are as follows: 


SIFE on Test end of task code equal to on 
SIFNE n Test end of task code not equal to n 
SIFL a Test end of task code less than n 
SIFNL non Test end of task code not less than on 
SIFS vn Test end of task code greater than n 
SIENG a Test end of task code not greater than oa 
In all casas, results of the test are “false", CSS = skips 
commands until corresponding SELSE or SENDC. If a Css 
attempts to skip beyond EOF, a command error is generated. 
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§.6.2 File Existence Testing Commands 


There are two commands dealing with rile existence: 


SIFX fd Test fd for existence 


SITFNX fd Test fd for nonexistencea 


Tf the result of the test is false, CSS skips to the 
corresponding SELSE or SENEC command. If a CSS attempts to skip 
beyond EOF, an error is generated. 
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5-9 SIFVOLUME COAMAND 


The SIFVOLUME command tests for the existence of a volume name in 
an fd. If a volume exists, subSequent commands are executed up 
to the next SELSE or SENCDCC command. If the volume is omitted in 
the fd, subsequent commands are skipped up to the next SELSE or 
SENDC command. 


Format: 
SITEYOLUME fd 
Parameters: 


fd is the file descriptor tested to determine if 
a volume name is included. 
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| SIFEXTENSION | 
5.8 SIFEXTENSION COMMAND 
The SIFEXTENSION command is used to test for the existence of an 
extension for a given fd. If the extension exists, subsequent 
commands are executed up to the next SELSE or SENDC command. If 


an extension does not exist, subsequent commands are skipped up 
to the next SELSE or SENDC command. 


Formats: 
SIFEXTENSION fd 


Parameter: 


fd is the file descriptor to be tested to 
determine if an extension is included. 


Functional Details: 


SIFEX (with no fd) is always considered false. 
SIFNEX (with no fd) is always considered true. 


5.6.3 Parameter Existence Testing Commands 


There are two commands dealing with the existence of parameters: 


SITFNULL an Test an null 

SIFNNULL = aon Test adn not null 
If the result of the test is false, CSS. skips to the 
corresponding SELSE or SENEC command. If such skipping attempts 
to skip beyond EOF, a command error is given. 
The use of the multiple ad notation to test for the existence of 


higher level parameters is permitted. In addition, a combination 
of parameters can be tested simultaneously. 


Examples: 
SIFNU@ 40 29 3 


In effect, this tests the logical OR of a1, @2, and 2903 for | 
nullity. If any of the three is present, the test result is 
false. 


ry fies 


5.10 LOGICAL LF UVa wee 


The following logical IF commands are used to compare two 


arguments. They differ from the other logical IF commands in 
that they da not test specific built-in conditions but, rather, 
test conditions provided by the user. These commands are 


available only with MTH. 


‘ @lz@e 
eo «© « EQUAL 

SIF . . « NEQUAL 

SIF . .« « GREATER 

SIF .« « « NGREATER 

Slt «.«. « LESS 

SIF .« « »« NLESS 


For each of the logical commands, two arguments are compared 
according to the mode. There are three valid modes: 

e Character 

@® Lecimal 


e hexadecimal 


For character mode, the comparison is left-to-right and is 
terminated on the first pair of characters that are not the same. 
If one string is exhausted before the other, the short string is 
less than the long string. If both strings are exhausted at the 
same time, they are equal. For character mode, the arguments can 
be enclosed in double quotes if they contain blanks. The quotes 
are not included in the compare. 


For decimal and hexadecimal mode, the comparison is performed by 
comparing the binary value of the numbers. 


If after comparing the arguments for each of the commands, the 
condition is determined to be true, subsequent commands are 
executed up to the corresponding SELSE and SENDC. If the 
condition is false, commands are skipped up to the corresponding 
SELSE or SENDC. 
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5.10.1 SIF..e-EQUAL, SIF.~--NEQUAL Commands 
The SIF...-EQUAL command is used to determine if two arguments are 


equal, while the SIF..-NEQUAL is used to determine if two 
arguments are not equal. 


Format: 


CHARACTER ) @/= @A 
SIF DECIMAL arg; EQUAL arg, 


HEXADECIMAL 


CHARACTER @l=- @4 
SIF DECIMAL arg, NEQUAL arg, 


HEXADECIMAL 


De IVUe & DLE eee GKLALLN, Ylr&Ee ee NGKEATER Commands 


The SIF..e-GREATER command is used to determine if argi is greater 
than arg2. The SIF..eNGREATER command is used to determine tit 
arg1 is not greater than arg2. 


Format: 
CHARACTER 
SIF DECIMAL arg, SREATER arg) 
HEXADECIMNAL 
CHARACTER 
SIF DECIMAL acg, NGREATER arg) 
HEXADECIMAL 


5.10.3 Si téwebEss; SIF.~.-eNLESS Commands 


The SIF...LESS command is used to determine if argi is less than 
arg2. The SIF..e..-NLESS command is used to determine if arg1 is 


not less than arg2. 


Format: 
CHARACTER 
SIF DECIMAL arg, LESS arg, 
HEXADECIMAL 
CHARACTER 
SIF DECIMAL arg, NLESS arg) 
HEXADECIMAL 
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5.7 $GOTO AND SLABEL COMMANDS pat oT Bo POR WARP a 
(0 Pi EF STREET 


The SGOTO command is used to skip forward within a CSS procedure. 
The SLABEL is used to define the object of a $GOTO. 


Format: 


$GOTO label 


S],ABEL label 
Parameters: 


Label is from one to eight alphanumeric characters, 
the first of which must be alphabetic. 


Functional Details: 


The SGOTO command causes all subsequent commands to be ignored 
until a SLABEL command with the same label as the SGOTO command 
is encountered. At that point, command execution resumes. 


The SGOTO cannot branch into a logical IF command range but can 
branch cut from one. 
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THE FOLLOWING IS A VALID EXAMPLE OF $60TO AND $LABEL: 


SIF < CONDITION > 
$6010 OUTIF 

SENDC 

SIF < CONDITION > 
sen 

$LABEL OUTIF 


-6]- 


THE FOLLOWING TS AN INVALID EXAMPLE OF $GOTO AND $LABEL: 


SIF < CONDITION > 
$600 OUTIF 

SENDC 

SIF <CONDITION > 
$LABEL OUTIF 


THE $LABEL OCCURS WITHIN AN-IF BLOCK (THE SECOND IF CONDITION) THAT WAS 
NOT ACTIVE WHEN $GOTO WAS EXECUTED. 
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HOW TO CREATE AND RUN A CSS FILE 
WRITE A CSS THAT EXECUTES THE FOLLOWINS STEPS: 
1. DISPLAY ALL USERS CURRENTLY SIGNED ON TO THE sysTEM, Va 
2. DISPLAY THE CURRENT TIME OF DAY, aC 


3, CREATE A FILE NAMED TMP.DAT THAT CONTAINS THREE RECORDS 
OF TEXT USING THE $BUILD. . . . $ENDB COMMANDS. 
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HOW TO CREATE AND RUN A CSS FILE 


ANSWERS 
“EDIT = CR 
OS/32 EDIT 
> AP 
1 DU <CR> 


2 DT <CR> 

3 $BUILD TMP.DAT <CR> 

4 THE SKY IS BLUE, <CR> 

5 THIS IS RECORD TWO, <CR> 
6 ISN'T THIS FUN! <CR> 

/ $ENDB <CR> 

8 


$EXIT <CR> 


ax. AY p Er 41445 YE 
CET tt omy 
9 CR> —T? 


>SA TEST,.CSS <CR> 
2END <CR> 


ci 


TO ENVOKE THE CSS TYPE:. 
> Beot GR 


